home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-04 / pcscev16.zip / MANUAL.DOC < prev    next >
Text File  |  1992-11-03  |  43KB  |  994 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.         PC-HyperText Architect Version 1.6 User's Manual
  26.  
  27.  
  28.    Copyright 1990-1992, Synergistic Consultants, Incorporated.
  29.  
  30.  
  31.                            November, 1992
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.                         Table of Contents
  54.  
  55.  
  56.  
  57.                Introduction                  Page 1
  58.                Setup                         Page 2
  59.                Valid Options                 Page 5
  60.                Runtime Parameter File Format Page 7
  61.                End of Line characters        Page 8    
  62.                Passwords                     Page 9
  63.                File names and keys           Page 11
  64.                Editor Commands               Page 12
  65.                Text Processor Commands       Page 13
  66.                Disclaimer                    Page 19
  67.                Order Form                    Page 20
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74. Introduction:
  75.  
  76. This program is intended for non-commercial, evaluational
  77. purposes only.  The PC-HyperText Architect program is designed to
  78. allow the computer user to design color screens with music and
  79. Hyper Text buttons with simplicity for any IBM PC or AT and
  80. compatible.  The minimum configuration is:
  81.  
  82.      Hard Disk drive or High density disk drive
  83.        (a low density drive could be used for very small          
  84.        applications). 
  85.      Monochrome, CGA, LCD or EGA/VGA display
  86.      640K of memory
  87.  
  88. This program uses a central database of item names and associated
  89. information that designate the location and length of each entity
  90. created.  This version allows the following entities:
  91.  
  92.      Help screen or window 
  93.      Songs.
  94.      Static text screen.
  95.      Passwords.
  96.      File names.
  97.  
  98. The Master Index file contains the information needed to access
  99. and retrieve each of these entities.  The Screen file contains the
  100. definition of each screen or song in the database.  The physical
  101. location (file, offset, length, etc.) is stored in the Master
  102. Index file, and the logical name (32 characters, non-case
  103. sensitive) is used to find these entities in this file.  Any
  104. song, screen or Hyper Text button is referenced with this logical
  105. name.  A Hyper Text button is an area on the screen that is
  106. sensitive to the mouse or the cursor, and results in a song or screen
  107. stored in the Screen file to be displayed or played.  When the
  108. cursor is positioned without the mouse, the TAB and BACKTAB keys
  109. move between active Hyper Text buttons and the ENTER key selects
  110. the next item to display or play.  The ESC key returns to the
  111. previous screen.  The mouse's left button is analogous to the
  112. ENTER key, and the right button performs the same function as the
  113. ESC key.  This program is menu driven, and takes little practice
  114. to master.
  115.  
  116. Setup:
  117.  
  118. To extract the program and associated files, type these commands
  119. (or the equivalent):
  120. Note that d: is the disk drive that is to contain the programs, and 
  121. s: is the external source disk drive.
  122.  
  123.   d:
  124.   MD \PCSCREEN  
  125.   CD \PCSCREEN
  126.   COPY s:PCSCEV16.ZIP .
  127.   COPY s:README.A16 .
  128.   COPY s:PKZ101.EXE .
  129.   PKZ101
  130.   PKUNZIP PCSCEV16.ZIP
  131.  
  132. The files require over 600K of disk space including the files
  133. distributed with the PKUNZIP program (the PK* files may be
  134. deleted if you so desire).
  135.   
  136. To run the Song / Screen Generator, type:
  137.  
  138.   BTCHBLDR /V TALNDEMO.RTP
  139.  
  140. This invokes the Song / Screen Generator in demo mode with the
  141. Parable of the Talents from the New Testament of the Bible as the
  142. example.  Whenever a screen is displayed, and a key needs to be
  143. typed to continue to the next screen or cursor position, three
  144. short beeps are heard on the computer's speaker.  After these
  145. beeps type any key (Carriage Return, or space for instance), and
  146. the next step in demo will be executed.  Any application
  147. generated with this package can be run in this mode also.  
  148.  
  149. Another set of demos are on this disk that demonstrate the
  150. Supervisory mode of this program.  Type:
  151.  
  152.        BTCHBLDR /S SUPRDEMO.RTP
  153.  
  154. This demo shows how password records can be displayed in
  155. Supervisory mode.  
  156.  
  157. A Master Index and Screen file of songs are on this disk 
  158. and may be viewed with the following command:
  159.  
  160.        BTCHBLDR /V SONGDEMO.RTP
  161.  
  162. This is a slideshow of songs and screens, and requires no 
  163. intervention.  Type Cntl C or ESC to abort this program.
  164.  
  165. To run the program in interactive mode, type:
  166.  
  167.        BTCHBLDR /I
  168.  
  169. This begins the program in interactive mode where the input files
  170. and the configuration can be specified (e.g. demo mode, output to
  171. the screen, etc.).  The first prompt asks if all input should be
  172. taken from a file.  This is where the input saved by this program
  173. (in the file specified at the second prompt) is specified so
  174. unaided generation of screens may take place.  The next prompt
  175. asks if all fields should be written out to a file.  This feature
  176. should be used if screens are to be rebuilt often, each field is
  177. saved into the specified file for use later.  Of course, the
  178. bifurcations at questions may be different (e.g. if files exist
  179. the second time) so care must be taken.  If input is taken from a
  180. file, then single step or demo mode may be selected.  In demo
  181. mode, when each field is input, three short beeps are heard on
  182. the speaker and then the program waits for a keystroke from the
  183. keyboard (type any character except ESC).  The Master Index file
  184. name is requested from the operator, with the password.  The
  185. passwords for the default files are:
  186.  
  187.      PCSCREEN.MDX   External Password:  PASSWORDMDX
  188.                     Internal Password:  MDXPASSWORD
  189.      PCSCREEN.SCR   External Password:  PASSWORDSCR
  190.                     Internal Password:  SCRPASSWORD
  191.      Supervisory    External Password:  SUPERPASSWORD
  192.                     Internal Password:  PASSWORDSUPER
  193.  
  194. The Master Index file contains the name and location of every
  195. screen, song and item in the database.  The Screen file name is
  196. requested from the operator with its password next.  This file
  197. contains all the HyperText screens and the songs in the database. 
  198. After this, a blue screen shows the control record of the Master
  199. Index File that was specified.  The program after this point is
  200. almost self-explanatory. The fields entry allows the use of the
  201. cursor key pad to edit the field.  The insert, delete, page up,
  202. and page down keys are all supported.  Notice that the screens 
  203. that have HyperText links in them are type 10 (Major Help Screen 
  204. for Help Level 2) or type 11 (Minor Help Screen for Help Level 1) 
  205. but the ones that are the end of a chain of HyperText or do not 
  206. have HyperText links are type 12 (Screen Commands).  The Help 
  207. levels are used in the new PC-APPLICATOR product, and allow the 
  208. designer to choose the size and detail of two levels of help.  
  209. This could be used by screen designers with this version of 
  210. PC-HyperText Architect for upward compatability with future releases.  
  211. A good suggestion is to choose option number 4 on the main menu 
  212. and step through the screens one by one to examine each one.  
  213. The following screen files and Master Index Files are on this disk:
  214.  
  215.   SONGS.MDX            (* Master Index file for songs.   *)
  216.   SONGS.SCR            (* Screen file for songs.         *)
  217.   TALENTS.MDX          (* Master Index file for Parable  *)
  218.   TALENTS.SCR          (* Screen file for Parable        *)
  219.   PCSCREEN.MDX         (* Supervisory and password demo  *)
  220.   PCSCREEN.SCR         (* Empty with this version.       *)
  221.   PCSCR$$$.MDX         (* Master Index file for BTCHBLDR *)
  222.   PCSCR$$$.SCR         (* Screen file for BTCHBLDR       *)
  223.  
  224. All of these files have a secret Supervisory pass key except
  225. PCSCREEN.MDX.  This file uses the default Supervisory pass key. 
  226. See the section in the user's guide about Valid Options or
  227. Passwords for more information about pass keys.  These files all
  228. have passwords.  The Runtime Parameter files contain the external
  229. passwords in them.  The SONGS files contains some songs to
  230. demonstrate the music capability of this system.  The TALENTS
  231. files contain a tutorial on one of the parables of the New
  232. Testament of the Bible.  The PCSCR$$$ files are the internal
  233. files used by the Song / Screen Generator itself.  A description of
  234. the text processor commands may be found later in this file. 
  235. These commands allow the user to build windows of color static
  236. text in a manner similar to a text processor.  Once you build
  237. your own screens with Hypertext capabilities (see the example TXT
  238. files for ideas), you may test them with selection 6 on the main
  239. menu of the Song / Screen Generator program.  
  240.  
  241. The starting or initial screen is prompted for when you select
  242. option 6.  After entering the initial screen's name, everything
  243. is automatic.  The Hypertext capability is database driven from
  244. the Master Index File and Screen File generated with the Batch
  245. Screen Builder program.  The initial screen name:
  246.  
  247.      DEMO_INITIAL_SCREEN 
  248.  
  249. invokes the same set of HyperText help screens used by the Batch
  250. Screen Builder program (the password for this screen is the same
  251. as for the Screen file: PASSWORDSCR).
  252.  
  253. The SONGS files contain songs to replay.  Run the BTCHBLDR
  254. program and specify SONGS.MDX for the Master Index file, and
  255. SONGS.SCR for the screen file.  Choose option 4 to cycle through
  256. those screens.  A runtime parameter file is provided called:
  257. SONGS.RTP for your convenience.
  258.  
  259. The TALENTS files contain a short tutorial on the Parable of the
  260. Talents in the New Testament of the Bible.  Choose option 6 and
  261. specify START_THE_TALENTS_PARABLE at the prompt, this steps the
  262. user through the tutorial.  The runtime parameter file:
  263. TALNDEMO.RTP begins the talents parable in demo mode, as described
  264. before.  The runtime parameter file: TALENTS.RTP begins the Batch
  265. Screen Builder with the talents database for your interactive
  266. perusal.  
  267.  
  268. Another file: PCSCR$$$.ERR, is required in the directory that
  269. BTCHBLDR is run.  This file contains the error messages for
  270. runtime errors encountered in the Song / Screen Generator.
  271.  
  272. Valid Options:
  273.  
  274. The following options are available (or proposed) for use:
  275.  
  276.        /I - Interactive input for initialization (replaces the
  277.             *.RTP file).
  278.        /L - Use the LCD color table specified in the Runtime
  279.             parameter file (overrides the autosense nature of the
  280.             software to detect the display type).
  281.        /P - Process using the prompt file instead of the Menu, 
  282.             Form, and associated files.  This gives bootstrap
  283.             capability to applications that need further testing
  284.             of the menus and forms.  It runs slower, but the
  285.             menus and forms may be more volatile until the        
  286.             application is stable. (Not available with the        
  287.             evaluation version 1.6).
  288.        /D - Use defaults for:
  289.             Keyboard input file = NONE
  290.             Keyboard audit trail file = NONE
  291.             Screen output = YES
  292.             Sound output = YES
  293.             Demo mode = NO
  294.             Printf escape character = ~
  295.               (Also used in defining HyperText screens in the 
  296.                Production version of this program).
  297.             Monochrome VLT values = 0 .. 15
  298.             CGA VLT values = 0 .. 15
  299.             EGA/VGA VLT values = 0 .. 15
  300.             LCD VLT values = 0 .. 15
  301.             End of Line characters = 9 222 5 13 155 21 4 27 0 0
  302.                                      96 0 0 0 0 0 0 0 0
  303.        /F - Use defaults for the Master Index file and screen
  304.             files: 
  305.             Master Index file = PCSCREEN.MDX
  306.             Password for above = BLANK
  307.             Screen file = PCSCREEN.SCR
  308.             Password for above = BLANK
  309.        Note: BTCHBLDR /D /F  
  310.             is the same as an *.RTP file with the above defaults.
  311.        /S - Supervisory mode for extended debugging and utility
  312.             functions such as password perusal.  In Supervisory
  313.             mode, internal passwords are displayed whenever any
  314.             records are displayed.  An internal Supervisory
  315.             password cannot be viewed without entering it.  This 
  316.             prevents people that know the external Supervisory
  317.             password from viewing or changing the internal one
  318.             (the Supervisory pass key is also displayed with the
  319.             Supervisory password as the file name).
  320.        /K - User provided pass key.  The option: /Kxxxxxxx        
  321.             designates the string: 'xxxxxxx' (32 chars. max.) as
  322.             the current pass key for Supervisory password         
  323.             processing.  This gives the operator the capability  
  324.             to encrypt the Supervisory password with a unique    
  325.             key.  The Master Index file specified at startup must
  326.             have this pass key in its control record or the Batch
  327.             Screen Builder aborts (unless the Master Index file  
  328.             was created at startup).  This will prevent people   
  329.             from modifying or trashing your valuable data without
  330.             this key.  If this option is not used, a default pass
  331.             key is used.  This pass key is: 
  332.  
  333.                ABCDEFGHIJKLMNOPQRSTUVWXYZ123456
  334.  
  335.             Anyone creating a Supervisory password should give
  336.             this string, (or the one with the /K option) at the
  337.             prompt:
  338.  
  339.                Enter the file name this password protects:
  340.  
  341.             When creating a password from the main menu (option
  342.             7).  This gives another level of protection for the
  343.             designer's data (without this, anyone could create a
  344.             Supervisory password, and view or modify your data).
  345.        /E - User error recovery. (Not available in evaluation
  346.             version 1.6).
  347.        /J - Open journal file that logs all I/O operations.
  348.             This file(s) are named: ERROR$$$.Lxx, and are recreated
  349.             whenever this option is used.  This option can only
  350.             be used in Supervisory mode. (Not available in 
  351.             evaluation Version 1.6).
  352.        /T - Audit trail file is opened for tracing procedure
  353.             calls. (Not available in evaluation version 1.6).
  354.        /R - Row/Column mode for the X and Y coordinates input,
  355.             format is: Y, X instead of X, Y as usual.
  356.        /V - View only or read only mode.  Records can only be
  357.             viewed, not modified.  Passwords cannot be viewed. 
  358.             The /S option (Supervisory mode) overrides this flag. 
  359.             If the Master Index file and the Screen file need a
  360.             password, viewing cannot be done without knowing
  361.             them.
  362.        /U - User HyperText mode.  When this option is used, the
  363.             last line in the xxxxxxxx.RTP file specifies the name
  364.             of the screen to display as the entry screen.  With later
  365.             versions of this program, imbedded programming language
  366.             commands or menu commands may allow applications to be 
  367.             built this way. (Not available in evaluation Version 1.6).
  368.        /M - Inhibit the internal Master Index from being used.  This
  369.             option is for the production version, when rebuilding a
  370.             new database version, or for sidestepping the entry screen.
  371.             (Not available with evaluation Version 1.6).
  372.        /C - Custom version string.  The option: /Cxxxxxxx allows running
  373.             this software with databases that had other version strings
  374.             than the default version string.  Any data generated will 
  375.             inherit this version string.  (Not available with evaluation
  376.             Version 1.6).
  377.        /A - Any version string.  The data generated with this option will
  378.             work with any version of this software.  This is useful for 
  379.             data intended for the public domain to be freely used.  (Not 
  380.             available with evaluation Version 1.6).
  381.  
  382. The format of the Runtime parameter file (*.RTP) is:
  383.  
  384.        Keyboard input file if batch or demo modes
  385.        Audit trail log file for keystrokes
  386.        Demo mode flag (YES or NO)
  387.        Process delay for delaying between fields (used in batch   
  388.          mode to slow down processing so it can be viewed).
  389.        Screen output flag (YES or NO)
  390.        Sound output flag (YES or NO)
  391.        Alternate escape character for SPRINTF().  This controls   
  392.          the special format sequences.  For example: '%~s' is a   
  393.          pointer to a pointer to a string variable in SPRINTF(). 
  394.          The default character is: '~'.  This will also be used 
  395.          as an alternate way to specify a HyperText screen and
  396.          a HyperText button in the Production version of this 
  397.          product.  A '~' in the first column will specify the
  398.          name of a HyperText screen, the '~' preceeding an 
  399.          identifier within the text will denote a HyperText
  400.          button.
  401.  
  402.          ~MAIN_ENTRY_SCREEN
  403.            This program has ~3DataBase, and ~4Networking capabilities.
  404.                                    .
  405.                                    .
  406.                                    .
  407.  
  408.          The words DataBase and Networking are defined HyperText
  409.          screens, and the highlight colors are 3 (Cyan) for DataBase,
  410.          and 4 (Red) for Networking.  This feature is to be in the
  411.          Production version (not available in the Evaluation version).
  412.  
  413.        Master index file name
  414.        Master index file password
  415.        Screen file name
  416.        Screen file password
  417.        Monochrome VLT or color table, sixteen values that are the
  418.          actual values sent to the screen when that color number
  419.          is selected.
  420.        CGA color table
  421.        EGA/VGA color table
  422.        LCD color table
  423.        End of Line characters.  
  424.        Supervisory password or User initial screen name (/U option).
  425.  
  426. End of Line characters description:
  427.  
  428. This is an array of eighteen character codes that are accepted as
  429. the terminators for fields.  The following are given special
  430. positional significance:
  431.  
  432.            Position 1 and 10: TAB character
  433.            Position 2 and 11: BACKTAB character
  434.            Position 3 and 12: End of Form
  435.            Position 4 and 13: Carriage Return
  436.            Position 5:        Tab-o-matic flag, set to non-zero,
  437.                               denotes that the cursor should
  438.                               advance to the next field if a
  439.                               destructive character is typed in
  440.                               the last position of the input
  441.                               field.
  442.            Position 6 and 15: Field above character - moves to
  443.                               the field above
  444.            Position 7 and 16: Field below character - moves to
  445.                               the field below
  446.            Position 8 and 17: Abort character, usually ESC
  447.  
  448.        The alternate positions are to allow non-printable or odd
  449.        key combinations for batch input in forms.  Position 12    
  450.        defaults to the grave accent or circumflex character, so   
  451.        forms may be terminated in batch mode.
  452.  
  453. Passwords:
  454.  
  455. This program allows passwords on files.  Each entity associated
  456. with that file inherits the password that protects the file.  A
  457. blank password is not processed, and allows infinite access to
  458. the data associated with the password.  A password, like all
  459. other entities, has a record in the Master Index file.  To
  460. protect shared data bases, each password has an internal or
  461. hidden password associated with it.  When a database is shared
  462. with others, the internal password is not known to everyone using
  463. it, just the external password or the password key.  This
  464. prevents people from taking the useful data generated by you and
  465. using it for their programs.  The external password is 32
  466. characters, and can be any character sequence, and is always case
  467. sensitive.  The internal password is the same, but is encoded
  468. into a form that is not readable by just glancing at it.  When
  469. using a program, the external password must be known to use the
  470. data, but to change the internal password, the current internal
  471. password must be known.  Only someone in Supervisory mode can
  472. view the password field of any record.  The option to change
  473. a password in the main menu of the Song / Screen Generator program
  474. allows new password records to be added, or existing passwords to
  475. be changed.  Three tries are given for completing these
  476. operations: external password search in Master Index file and the
  477. validation attempts against the Master Index file record for the
  478. file that the password protects.  Three tries are also given for
  479. the internal password verification if the internal password is to
  480. be changed.  This process can be confusing, but gets easier with
  481. practice.  If the operator is one that can create a password, a
  482. new password record will be created if the external key entered
  483. is not in the Master Index file, and the operator desires to
  484. create one (external passwords are all that are allowed at
  485. program startup).  If the external key is one that exists in the
  486. Master Index file, but is not valid for the given file, three
  487. tries are given to get it right.  A chance is given to change the
  488. internal password, after validation.   Of course, the old
  489. internal password must be known in order to change the internal
  490. password, and this feature gives this system an advantage over
  491. conventional password processing; in order to change the true
  492. password, the internal password must be known.  Everyone else can
  493. know the external password key, but in order to change the
  494. password that is stored, you must have more information.  One
  495. level of passwords is insufficient in a system that is publicly
  496. accessed because once someone knows the entry password, they can
  497. change this password if desired (such as the UNIX system).  The
  498. procedure that inputs the password is very versatile, and is used
  499. in a different mode when a password is to be changed rather than
  500. created.  This one feature gives PC-HyperText Architect an edge
  501. over most other products in its category.
  502.  
  503. The Supervisory mode (/S option) requires a password that is
  504. stored in the Master Index file.  Actual internal passwords
  505. cannot be viewed unless the operator is in Supervisory mode.  A
  506. blank password for a file cannot be changed unless the operator
  507. is in Supervisory mode.  The basic idea behind the Supervisory
  508. password is that each Master Index file generated should contain
  509. a Supervisory password entered by the System Administrator, or
  510. the one responsible for that file.  The Supervisory password is
  511. different because the file name that the password protects is an
  512. internal key (pass key), and can be specified to be unique for
  513. different versions of the data this product generates (see the 
  514. /K options).  This method will guarantee file security if the /K
  515. option is specified when the Master Index file is created. The
  516. unique pass key option (/K) provides a method of restricting the
  517. access to any file's password records by allowing entry into the
  518. system with only the pass key that was used when the Master Index
  519. file was created.  The internal passwords that are generated will
  520. be unique for different file names, because the file name (or
  521. pass key for Supervisory passwords) is combined with the password
  522. when the internal password is generated.  The encryption
  523. algorithm is one that minimizes flukes of translation that
  524. generate duplicate internal passwords.  Passwords should be some
  525. sequence of characters that are unique and contain few duplicate
  526. characters.  The same internal password typed from the keyboard
  527. should generate a different internal password that is stored for
  528. file names that are not the same, the operator may use their own
  529. descretion about this choice (all passwords are deencrypted when
  530. viewed in Supervisory mode).  When a new password is entered from
  531. the main menu option 7, the file name the password protects has
  532. to be a file that has a record in the Master Index file, or the
  533. pass key entered when the Master Index file was created.  This
  534. prevents any extraneous Supervisory passwords from being entered
  535. into any Master Index file; they all must use the pass key
  536. entered when the file was created.
  537.  
  538. File names and keys:
  539.  
  540. A file name is a upper or lower case string including path and
  541. disk drive specifier, and they may be up to 32 characters long. 
  542. These are kept internally in the Master Index file, but the name
  543. is always accessed by the file name key.  The file name key is
  544. internally generated by this program and consists of the body of
  545. the file name and the extension concatenated together.  Remember
  546. that any item name is case sensitive, so the case of file names
  547. is critical when they are being entered.  An example of a file
  548. name and the file key is:
  549.  
  550.      C:\PCSCEVAL\TEST.SCR
  551.  
  552. would have the following key:
  553.  
  554.      TESTSCR
  555.  
  556. blank filled.  This will be the key that this file name is to be
  557. accessed with when the program runs.  Any file access uses this
  558. key to find the actual name and associated information for this
  559. physical data file.
  560.  
  561. If the file key generated is not in the user specified Master
  562. Index file, but one that is in the control Master Index file
  563. (e.g. PCSCR$$$.MDX), then the internal pass key for the control
  564. Master Index file is requested before the operator can continue. 
  565. This prevents unauthorized use of the system files.  The internal
  566. pass key in the control Master Index file is checked when it is
  567. opened to guarantee that the Song / Screen Generator program is
  568. running with its own file.
  569.  
  570. In future releases, the option to include a subset of the path
  571. in the file key will be offered.  
  572.  
  573. This section describes the operation of the built-in full screen
  574. editor in the Song / Screen Generator program:
  575.  
  576.        The keys on the keyboard that are active are:
  577.  
  578.        Ins  - Inserts a space at the cursor position
  579.        Del  - Deletes the character under the cursor
  580.        PgUp - Scrolls the information above the window down into
  581.               the window (moves the window up)
  582.        PgDn - Scrolls the information below the window up into
  583.               the window (moves the window down)
  584.        Home - Moves the cursor to the beginning of the line
  585.        End  - Moves the cursor to the end of the line
  586.        Right arrow - Moves the cursor one position to the right
  587.               with wrap around to the left side of the screen.
  588.        Left arrow  - Moves the cursor one position to the left
  589.               with wrap around to the right side of the screen.
  590.        Up arrow    - Moves the cursor up one position with wrap
  591.               around to the bottom of the screen.
  592.        Down arrow  - Moves the cursor down one position with wrap
  593.               around to the top of the screen.
  594.        Ctrl PgUp   - Deletes the line at the current cursor
  595.               position.
  596.        Ctrl PgDn   - Inserts a blank line at the current cursor
  597.               position.
  598.        Ctrl Right 
  599.             Arrow  - Moves the cursor over to the next word to
  600.               the right.
  601.        Ctrl Left
  602.             Arrow  - Moves the cursor over to the next word to
  603.               the left.
  604.        Enter       - Moves everything from the current cursor
  605.               position to the right down to the next line, and
  606.               puts a carriage return where the cursor was.
  607.        Esc  - Exits the editor.  A prompt asks whether your work
  608.               is to be saved.
  609.  
  610.      This editor is different from others in that the carriage
  611.      return, or end of line character shows up in the source file
  612.      as a little note character that you would see on a musical
  613.      scale.  This allows lines with trailing blanks, and allows
  614.      explicit placement of the end of line.  The limitations of
  615.      this editor are:
  616.  
  617.                1) No way to merge two lines.
  618.                2) No way to cut and paste.
  619.                3) Mouse moves the cursor only.
  620.                4) No search and replace.
  621.  
  622.      This is not a complete list, but improvement will come with
  623.      later versions.
  624.       Batch Text Processor Commands:
  625.  
  626.       .SC fgd_color bgd_color
  627.         
  628.           Set the color where 'fgd_color' is the foreground
  629.           color, and 'bgd_color' is the background color.  These
  630.           values may be a number between 0 and 15 or the words:
  631.           BLACK, BLUE, GREEN, CYAN, RED, MAGEN, BROWN, WHITE,
  632.           GREY, HIBLU, HIGRN, HICYA, HIRED, HIMAG, YELLO, HIWHT.
  633.  
  634.       .DW xul yul xlr ylr
  635.  
  636.           Set the current window to the values specified, upper
  637.           left and lower right corner values.  The mnemonics XRES
  638.           and YRES may be specified also.  The mnemonics: XVAL
  639.           and YVAL denote current cursor position when the
  640.           command is encountered.
  641.  
  642.       .SW xul yul xlr ylr
  643.  
  644.           Set the current window to the values specified, upper
  645.           left and lower right corner values.  After the window
  646.           is set, it is erased, and the coordinates for this
  647.           window are put into the window stack.  The mnemonics
  648.           XRES and YRES may be specified also.  The mnemonics:
  649.           XVAL and YVAL denote current cursor position when the
  650.           command is encountered.                                
  651.  
  652.       .EA xul yul xlr ylr
  653.  
  654.           Set the current window to the values specified: upper
  655.           left and lower right corner values.  After the window
  656.           is set, the area below the window is saved offscreen. 
  657.           Then the window is erased using the currently set
  658.           values for the foreground and background colors,      
  659.           and the coordinates for this window and the address of
  660.           where the window contents were saved are put into the
  661.           window stack. The mnemonics XRES and YRES may
  662.           be specified also.  The mnemonics: XVAL and YVAL denote
  663.           current cursor position when the command is
  664.           encountered.
  665.  
  666.       .SA xul yul xlr ylr
  667.  
  668.           Set the current window to the values specified: upper
  669.           left and lower right corner values.  After the window
  670.           is set, the area below the window is saved offscreen. 
  671.           The current values of the foreground and background
  672.           colors, and the coordinates for this window and the 
  673.           address of where the window contents were saved are put
  674.           into the window stack.  The mnemonics XRES and YRES
  675.           may be specified also.  The mnemonics: XVAL and YVAL
  676.           denote current cursor position when the command is
  677.           encountered.
  678.  
  679.       .RA
  680.  
  681.           Restore area.  The command restores the previously
  682.           saved window that was saved with the '.SA' command.
  683.  
  684.       .DS screen_name
  685.  
  686.           Display another screen or window.  This is executed
  687.           similar to a subroutine.  The screen that is specified
  688.           is displayed and if it is a HyperText window, the TAB,
  689.           BACKTAB, ENTER and ESC keys are active as well as the
  690.           cursor keys in browsing the HyperText.  If the screen
  691.           was not defined as a Help screen, a keystroke is       
  692.           prompted for before continuing at the next statement in
  693.           the source file.
  694.  
  695.       .PC x y
  696.  
  697.           Position the cursor to the specified x, y location. 
  698.           The mnemonics XRES and YRES may be specified.
  699.  
  700.       .BX lines
  701.  
  702.           Draw a box within the currently set window with one or
  703.           two line thickness (lines = 1, 2).  The window is
  704.           decreased in both the x and y directions by one on the
  705.           upper left and lower right.
  706.  
  707.       .CS any string
  708.  
  709.           Center the specified string within the current window
  710.           on the current row.  The string is considered to be all
  711.           characters up to the carriage return line feed
  712.           combination (including blanks).
  713.  
  714.       .FI
  715.         
  716.           Sets the mode for placing text to: Fill Mode.  Words
  717.           that would be split at the end of the window are placed
  718.           starting at the beginning of the next line in the
  719.           window.
  720.  
  721.       .NF
  722.  
  723.           Sets the mode for placing text to: No Fill Mode.  The
  724.           text is written into the window without checking if
  725.           words will be split and wrapped around to the next
  726.           line.
  727.  
  728.       .SE
  729.  
  730.           Screen end command.  Signals the end of the input file.
  731.  
  732.       .PS song_name repeat_cycles
  733.  
  734.           Play song.  The song by the name: 'song_name' in the
  735.           current master index file is read and played.  The
  736.           field: 'repeat_cycles' designates the number of times
  737.           to repeat the song.
  738.  
  739.       .PL repeat_cycles num_notes f1 d1 f2 d2 ... fn dn
  740.  
  741.           Play tune.  Play the tune defined by the frequency,
  742.           duration pairs on the input line ('fx', 'dx').  The
  743.           field: 'repeat_cycles' specifies the number of times to
  744.           repeat this tune.  The frequencies of notes is
  745.           specified in 1 HZ increments (e.g. 1 cycle per second).
  746.           The duration of notes is specified in 10 MS increments
  747.           (e.g. 100=1 second).  The following words (mnemonics)
  748.           may be substituted for readability and convenience:
  749.  
  750.                C       -       Middle C' (264 HZ)
  751.                CSHRP   -       C' sharp  (280 HZ)
  752.                D       -       D'        (297 HZ)
  753.                DSHRP   -       D' sharp  (313 HZ)
  754.                E       -       E'        (330 HZ)
  755.                F       -       F'        (352 HZ)
  756.                FSHRP   -       F' sharp  (374 HZ)
  757.                G       -       G'        (396 HZ)
  758.                GSHRP   -       G sharp   (418 HZ)
  759.                A       -       A'        (440 HZ)
  760.                ASHRP   -       A' sharp  (467 HZ)
  761.                B       -       B'        (495 HZ)
  762.                HI_C    -       C above middle C (High C or C'')
  763.                                    (528 HZ)
  764.                HI_CS   -       C sharp above middle C (C''#)     
  765.                                    (544 HZ)
  766.                HI_D    -       D''       (561 HZ)
  767.                HI_DS   -       D'' sharp (577 HZ)
  768.                HI_E    -       E''       (594 HZ)
  769.                HI_F    -       F''       (616 HZ)
  770.                HI_FS   -       F'' sharp (638 HZ)
  771.                HI_G    -       G''       (655 HZ)
  772.                REST    -       No sound
  773.  
  774.         All frequencies are approximate.
  775.  
  776.         The durations may be specified with the following single
  777.                words:
  778.  
  779.                WHOLE   -       Whole note
  780.                HALF    -       Half note
  781.                QRTR    -       Quarter note
  782.                EIGHT   -       Eighth  note
  783.                SIXTN   -       Sixteenth note
  784.  
  785.         Example:
  786.  
  787.          .PL 1 5 C WHOLE REST SIXTN B QRTR REST 1 ASHRP HALF
  788.  
  789.       .TE tempo
  790.  
  791.         Set the tempo for playing music.  The valid values for
  792.           'tempo' are:
  793.  
  794.                ADAGI   -       Adagio or slow      
  795.                     (Quarter note = 60 cpm)
  796.                MODER   -       Moderato or medium  
  797.                     (Quarter note = 90 cpm)
  798.                ALLEG   -       Allegro or fast     
  799.                     (Quarter note = 120 cpm)
  800.                PREST   -       Presto or very fast 
  801.                     (Quarter note = 240 cpm)
  802.  
  803.         The default is presto.  
  804.           ('cpm' is the approximate number of cycles per minute).
  805.  
  806.       .TU f1 d1 f2 d2 ... fn dn
  807.  
  808.           Build a tune to be stored on the disk.  The f1 ... fn
  809.           (frequencies) can be the words specified above.  
  810.           The d1 ... dn (duration) can be one of the appropriate
  811.           words above.  This command can only be used when the
  812.           types 13 or 15 (Song commands type) is specified when
  813.           building a record in the Song / Screen Generator (option
  814.           1).  The only other command allowed to define a song
  815.           that is saved in a Screen File is .TE described above.
  816.  
  817.       .SD
  818.  
  819.           Stop the date/time display.
  820.  
  821.       .ST
  822.  
  823.           Stop tunes.  The song or tune that is playing is
  824.           stopped.
  825.  
  826.       .WS
  827.  
  828.           Wait for a song or tune to stop playing before
  829.           continuing.
  830.  
  831.       .HB hyper_text_window_name width
  832.  
  833.           Define a hyper text button.  The area beginning where
  834.           the cursor is positioned, through the character
  835.           positions to the right are made an active hyper text
  836.           button.  The width of the active area is specified on
  837.           the command line.  When this button is pressed, the 
  838.           window specified by 'hyper_text_window_name' is drawn
  839.           on the screen.
  840.  
  841.       .HW hyper_text_window_name
  842.  
  843.           Define a hyper text window.  The area defined by the
  844.           current window is made an active hyper text button. 
  845.           When this button is pressed, the window specified by
  846.           'hyper_text_window_name' is drawn on the screen.
  847.  
  848.       .PA
  849.  
  850.           Pause the display of the screen and wait for a
  851.           keystroke.
  852.  
  853.      .BE
  854.        
  855.           Sound the speaker with the sound of disapproval (BEEP).
  856.           This sound is defined to be a low toned grump.
  857.  
  858.      .BL
  859.  
  860.           Sound the speaker with the sound of approval (BLEEP).
  861.  
  862.      .BB
  863.  
  864.           Sound the speaker with the sound of attention (BEEP
  865.           BEEP BEEP).
  866.  
  867.      .SL cycles
  868.  
  869.           Sleep or wait for the designated number of cycles.  The
  870.           'cycles' field is specified in milliseconds.
  871.  
  872.      .RD x y fgd bgd
  873.  
  874.           Display the real-time date at position x, y and color
  875.           fgd, bgd.  The format is: MM/DD/YY, and goes to the
  876.           next day on the screen at midnight.
  877.  
  878.       .RT x y fgd bgd
  879.  
  880.           Display the real-time time at position x, y and color
  881.           fgd, bgd. The format is: HH:MM:SS, and is updated every
  882.           second.
  883.  
  884.      .EX command_name
  885.  
  886.           Execute the specified command record built previously. 
  887.           This command will be disabled until implemented
  888.           sometime in the future.
  889.  
  890.      .. any comment
  891.       
  892.           Two dots specify a comment line.
  893.         
  894.       any ascii text data at all
  895.       
  896.           Any ascii text data on the line by itself without a
  897.           period preceding it will be output into the current
  898.           window at the current cursor position.
  899.  
  900.       Simple arithmetic may be performed on numeric fields.  An
  901.           example:
  902.  
  903.         .PC XRES-10 YRES-1
  904.  
  905.      Only addition and subtraction may be performed with '+' and
  906.      '-'.
  907.  
  908. Disclaimer:
  909.  
  910.  
  911. The programs distributed within the PCSCEV16.ZIP file associated
  912. with this disclaimer are copyrighted by Synergistic Consultants,
  913. Incorporated.  The phrase: "Intuitionware--Revealing Your Hidden
  914. Creativity" is the trademark of Synergistic Consultants,
  915. Incorporated.
  916.  
  917. The program and the associated files are offered "as is" without
  918. any warranty of any kind.  Synergistic Consultants, Inc., does
  919. not guarantee, warrant or make any claims as to the correctness, 
  920. accuracy, reliability or currentness of the programs distributed 
  921. with this file.  
  922.  
  923. Synergistic Consultants, Incorporated, or anyone involved in the
  924. creation or distribution of these programs shall not be liable
  925. for any direct, indirect, consequential, or incidental damages
  926. (including lost business profits, interruption of business, loss
  927. of information or the like), resulting from the usage of these
  928. programs.  The entire risk rests upon the user for the
  929. performance and the results generated by these programs.
  930.  
  931. These programs are offered for non-commercial, personal
  932. evaluational purposes only.  These programs may be shared if no
  933. more than $5 is tendered to defray the duplication costs.
  934.  
  935.  
  936.  
  937.        Batch Screen Builder Production Disk, Version 1.6
  938.        PC-HyperText Architect and PC-SCREEN Registration
  939.        (Turbo Pascal Version)
  940.  
  941.        Send to:   Synergistic Consultants, Incorporated
  942.                   Post Office Box 18888
  943.                   Dept. 92SIGb
  944.                   Huntsville, AL 35804-8888
  945.  
  946.        Name:       _________________________________________
  947.        Company:    _________________________________________
  948.        Address:    _________________________________________
  949.                    _________________________________________
  950.        City:       _________________________________________
  951.        State:      ______________ Zip Code: ________________
  952.        E-Mail Address:  ____________________________________
  953.        Phone:      _________________________________________
  954.        
  955.  
  956.        PC-HyperText Architect Version 1.6: 
  957.          Registration license, the printed
  958.          bound manual and product update
  959.          announcements.
  960.                                            $35    __________
  961.        PC-HyperText Architect Version 1.6: 
  962.          Registration license only, the printed
  963.          bound manual.
  964.                                            $15    __________
  965.                        or
  966.        PC-SCREEN Utilities Version 1.0:    
  967.          Registration license, the printed
  968.          bound manual and product update
  969.          announcements.
  970.                                            $75    __________   
  971.  
  972.        PC-SCREEN Utilities Version 1.0:    
  973.          Registration license only, without 
  974.          the printed bound manual.
  975.                                            $55    __________   
  976.  
  977.         (To upgrade to PC-SCREEN from PC-HyperText
  978.          Architect use the Registration form from
  979.          the Registered PC-HyperText Architect 
  980.          disk)
  981.                               
  982.                               Amount Enclosed:    __________ 
  983.  
  984.        Diskette Type: 5 1/4" ______ or
  985.                       3 1/2" ______
  986.  
  987.        Where did you receive the Evaluation Disk?
  988.        _____________________________________________________
  989.        Comments:  __________________________________________
  990.        _____________________________________________________
  991.        _____________________________________________________
  992.        _____________________________________________________
  993.  
  994.